home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 1.6 / Buddy API Docs.swf / texts / 1514.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  2.8 KB  |  113 lines
  1. 119
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. FileDateEx 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baFileDateEx returns the date of a file as a string.
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = baFileDate( FileName , DateType , DateFormat , TimeFormat )
  28. --- RECORDSEPARATOR ---
  29.  
  30. --- RECORDSEPARATOR ---
  31. Arguments:
  32. --- RECORDSEPARATOR ---
  33.  
  34. --- RECORDSEPARATOR ---
  35. String, string, string, string 
  36. --- RECORDSEPARATOR ---
  37. FileName is the file to get the date of. 
  38. --- RECORDSEPARATOR ---
  39. DateType is the data to return. Can be one of: 
  40. --- RECORDSEPARATOR ---
  41. "created" 
  42. --- RECORDSEPARATOR ---
  43. "modified" 
  44. --- RECORDSEPARATOR ---
  45. "accessed" 
  46. --- RECORDSEPARATOR ---
  47. DateFormat is the desired format of the date, 
  48. --- RECORDSEPARATOR ---
  49. TimeFormat is the desired format of the time.
  50. --- RECORDSEPARATOR ---
  51.  
  52. --- RECORDSEPARATOR ---
  53. Returns:
  54. --- RECORDSEPARATOR ---
  55.  
  56. --- RECORDSEPARATOR ---
  57. String. 
  58. --- RECORDSEPARATOR ---
  59. Returns the date of the file, or an empty string if the file doesn't exist.
  60. --- RECORDSEPARATOR ---
  61.  
  62. --- RECORDSEPARATOR ---
  63. Examples:
  64. --- RECORDSEPARATOR ---
  65.  
  66. --- RECORDSEPARATOR ---
  67. Director: 
  68. --- RECORDSEPARATOR ---
  69. set date = baFileDateEx( "c:\data\student.dat", "created", "dd-mm-yy", "hh:nn:ss" ) 
  70. --- RECORDSEPARATOR ---
  71. Authorware: 
  72. --- RECORDSEPARATOR ---
  73. date := baFileDateEx( "c:\\data\\student.dat" , "modified" ,"dd-mm-yy" , "hh:nn:ss" )
  74. --- RECORDSEPARATOR ---
  75.  
  76. --- RECORDSEPARATOR ---
  77. Notes:
  78. --- RECORDSEPARATOR ---
  79.  
  80. --- RECORDSEPARATOR ---
  81. The date format can consist of "d" for day, "m" for month, "y" for year. 
  82. --- RECORDSEPARATOR ---
  83. The time format can consist of "h" for hours, "n" for minutes, "s" for seconds. (Note 
  84. --- RECORDSEPARATOR ---
  85. the "n" for minutes.) 
  86. --- RECORDSEPARATOR ---
  87. A single letter ("d") returns the exact number eg "5". 
  88. --- RECORDSEPARATOR ---
  89. A double letter ("dd") returns the number with a leading zero if required eg "05". 
  90. --- RECORDSEPARATOR ---
  91. A triple letter ("ddd") returns the short name eg "Mon". 
  92. --- RECORDSEPARATOR ---
  93. A quad letter ("dddd") returns the full name eg "Monday". 
  94. --- RECORDSEPARATOR ---
  95. Any letters other than those listed above will returned as is - they can be used for 
  96. --- RECORDSEPARATOR ---
  97. separators eg "dd-mm-yy" returns "05-11-97"; "d mmmm, yyyy" returns "5 
  98. --- RECORDSEPARATOR ---
  99. November, 1997" 
  100. --- RECORDSEPARATOR ---
  101. If the format is an empty string, then the date or time will not be returned.
  102. --- RECORDSEPARATOR ---
  103.  
  104. --- RECORDSEPARATOR ---
  105. See also:
  106. --- RECORDSEPARATOR ---
  107.  
  108. --- RECORDSEPARATOR ---
  109. baFileDate 
  110. --- RECORDSEPARATOR ---
  111. baFileAge 
  112. --- RECORDSEPARATOR ---
  113. baFileVersion